home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / dev / cross / devpic.readme < prev    next >
Text File  |  2000-05-02  |  9KB  |  218 lines
  1. Short:    PIC16 development package
  2. Author:   rdc@cyberstorm.mtu-net.ru (Denis I.Sotchenko)
  3. Uploader: rdc@cyberstorm.mtu-net.ru
  4. Version:  1.5
  5. Type:     dev/cross
  6. Replaces: dev/cross/devpic.lha
  7.  
  8. Current version of this package contains:
  9.  
  10. picprog  - my simple CLI-based PIC16 «development» programmer
  11. picasm   - PIC12/16 assembler by Timo Rossi
  12. picreset - «in-circuit reset» tool
  13. picrecv  - simple debugging tool for debug info printing
  14.  
  15. All tools have full source code, ready for recompile.
  16. Binaries for 68000 included.  You can recompile it for your CPU.
  17.  
  18. Included picasm version has some differencies from original 1.06
  19. version: some bugfixes and full PIC12/16 line support (from Microchip
  20. Product Line Card 3Q1999).  I do not guarantee correct fuses values,
  21. but current picprog anyway doesn't support fuses embedded in HEX file.
  22.  
  23. 1.4+ devpic package contains also MS-DOS version of picasm - it was
  24. done because I'm currently occupied in commercial PIC16 development,
  25. and my boss want to have ability to compile my source code :)  maybe
  26. it can be useful for similar purpose.  picasm.com was compiled using
  27. free Turbo C 2.01 (http://www.borland.com), and works even on PC/XT.
  28.  
  29. picprog supports all current PIC16 Flash microcontrollers: PIC16C8x,
  30. PIC16F8x, PIC16F62x, PIC16F87x.  It was really tested and works with
  31. PIC16F84 and PIC16F876.  It has intelligent programming algorithm -
  32. before location programming it will read old value and will program
  33. location only if it is different.  As a result, programming of new
  34. version of code may take only some milliseconds.
  35.  
  36. Additionally, picprog has SmartFlash algorithm, usable for new
  37. (PIC16F84A and others) Flash PICs.  If it will be enabled, picprog
  38. reads all code in temporary buffer and calculates time for two
  39. programming modes: erase programming cycles, and bulk erase and
  40. programming only cycles (programming only cycle for 16F87x is 2ms,
  41. erase programming - 4ms).  If there are only some differencies (for
  42. example, if you compile new version of code with only one new
  43. constant), erase programming cycle will be performed.  If there are
  44. MANY differencies (new commands at begin of program), picprog will
  45. erase all code (Bulk Erase command) and program chip by faster
  46. Programming Only commands.
  47.  
  48. At result, v1.2+ picprog may program new Flash PIC16 up to 5 (five)
  49. times faster than old picprog and some other programmers.
  50.  
  51.  
  52. PicProg usage:
  53.  
  54. picprog FILE [FORCE=xxxx] [CONFIGWORD=xxxx] [VERIFY] [SMARTFLASH=n]
  55.  
  56. FILE       - object file in Intel Hex format, generated by picasm or
  57.              any other PIC assembler.
  58. FORCE      - remove code protection with erase all code and data.
  59.              This configuration word will be written BEFORE code
  60.              programming and must not contain code protecting bits -
  61.              because code may be written only without code protecting.
  62. CONFIGWORD - this configuration word will be written after programming
  63.              of code.  It is the only way to do code protect.
  64. SMARTFLASH - enables SmartFlash algorithm as described above.
  65.              Argument is number of milliseconds required for
  66.              Programming Only cycle (5ms for PIC16F8xA, 2ms for
  67.              PIC16F62x and PIC16F87x).
  68.              SmartFlash DOES NOT WORK WITH PIC16C84 and PIC16F84!
  69. VERIFY     - additional verify cycle for better reliability.
  70.  
  71. Configuration word must be entered in decimal form.  You can find
  72. configuration word formats in PIC programming specifications may be
  73. found on Microchip website or free Microchip Technical Library CD-ROM.
  74.  
  75.  
  76. WARNING: picprog from version 1.3 has new version of hardware!  New
  77. hardware doesn't require manual switching of 12v programming voltage,
  78. and does it automatically.  New hardware is similar to old, and you
  79. can «upgrade» your old Epic programmer hardware.  But you aren't
  80. forced to do it - new picprog is fully compatible with old hardware.
  81. Version 1.4 introduces v2 of hardware - optional diode for PIC16F84
  82. in-circuit programming added.  It is not required in any other cases.
  83.  
  84. Some notes about hardware: I don't know non-exUSSR equivalents of used
  85. diodes and transistors.  Probably, you can use any existing silicon ones.
  86.  
  87.  
  88. Notes about In-Circuit Programming: picprog allows to prorgam PIC
  89. even in circuit, without removal from socket.  For using of this
  90. feature you must develop your circuit with following rules:
  91. - MCLR must be connected only with programmer - you can connect it
  92.   with +5v or reset scheme, supervisor, etc - after development
  93. - usage of RB6 and RB7 are not recommended.
  94. - PIC16F84 may be programmed incorrect, because of working internal
  95.   clock generator - internal programming logic of C84 and F84 shares
  96.   one program counter with CPU, and if quartz or RC generator was
  97.   started in programming mode and counts more than 72 cycles, program
  98.   will be written to wrong addresses.  devpic hardware v2 introduces
  99.   new optional circuit (see scheme) that can be connected to OSC1
  100.   (pin 16), and it will flush generation during programming.  Newer
  101.   Flash PIC16 devices do not require this.
  102.  
  103.   (Note: diode must be placed on PIC side, not on programmer side)
  104.  
  105.  
  106. PicRecv usage: simply start it and it will receive debug info.
  107. For detailed info see debug info sending sample - source/picsend.asm.
  108. PicRecv requires in-circuit programmer connection.  CTRL/C - exit from
  109. picrecv, CTRL/D resets PIC.
  110.  
  111. Note: both picprog and picrecv own parallel port and can't be started
  112.       simultaneously!
  113.  
  114.  
  115. PicAsm usage: included picasm package contains it's own documentation.
  116.  
  117.  
  118. All programs are tested and works ok with my current Amiga setup:
  119.  
  120. A1200 Magic (ESCOM) in Slim case
  121. A3000 external keyboard
  122. Chinon FZ-357A HD floppy from A4000
  123. 35Mb RAM - 2chip, 32+1fast
  124. Blizzard 1260, overclocked to 59MHz
  125. Blizzard SCSI Kit
  126. Seagate Barracuda ST32171N 2Gb, Fast SCSI-2, 9.2Mb/s
  127. Quantum Fireball TM3840A 3.6Gb, IDE
  128. Selfmade IDE accelerator (up to 5Mb/s)
  129. Panasonic CR-572B 2x, IDE
  130. Multitech MT2834ZDX, 28.8
  131. «Microvitec with DMS» 12" digital multisync
  132. CNet CN40BC 10Mbit combo PCMCIA Ethernet card
  133. Selfmade PIC-based PS/2 mouse controller and DATACOM PS/2 mouse
  134. POWERCOM UPS-400-A
  135. HP LaserJet 5L (manually exchanged with picprog if needed)
  136.  
  137.  
  138. System requirenents: OS 2.x (maybe - not tested yet)
  139.  
  140.  
  141. History:
  142.  
  143. version 1.5
  144. - added picrecv debugging tool w/src
  145.  
  146. version 1.4
  147. - new hardware version
  148. - added MS-DOS version of picasm
  149.  
  150. version 1.3a
  151. - added useful picreset tool w/src
  152.  
  153. version 1.3
  154. - added support for new version of hardware
  155.  
  156. version 1.2
  157. - code protecting support
  158. - SmartFlash algorithm
  159. - all hardware support moved to separate section of source code
  160. - bug fixed: parallel port hardware was not correctly allocated
  161. - only 68000 binaries included: no speed differencies was found
  162.  
  163. version 1.1
  164. - first Aminet release
  165.  
  166.  
  167. Future versions will have:
  168. - MUI GUI
  169. - more advanced bedugging tools
  170.  
  171.  
  172. picprog, picreset and picrecv are FREE and PUBLIC DOMAIN.  You can use
  173. them and source code for any puproses, incliding commercial use.
  174.  
  175. picasm has it's own license.
  176.  
  177.  
  178. Intel is a registered trademark of Intel Corporation
  179. Microchip, PIC and ICSP are registered trademarks of Microchip
  180. Technology Inc.
  181.  
  182.  
  183. ============================= Archive contents =============================
  184.  
  185. Original  Packed Ratio    Date     Time    Name
  186. -------- ------- ----- --------- --------  -------------
  187.     1922    1922  0.0% 03-Apr-00 20:25:10 +hardware.png
  188.    37536   21081 43.8% 15-Dec-99 04:27:42 +picasm
  189.    38818   21009 45.8% 26-Mar-00 18:08:58 +picasm.com
  190.     3852    2372 38.4% 03-Apr-00 19:37:20 +picprog
  191.      928     647 30.2% 24-Apr-00 16:50:40 +picrecv
  192.       64      52 18.7% 11-Aug-99 04:45:00 +picreset
  193.     7121    3304 53.6% 24-Apr-00 17:14:44 +readme
  194.     6789    1767 73.9% 27-Feb-00 08:49:02 +config.c
  195.     8508     980 88.4% 27-Feb-00 08:49:02 +devices.c
  196.     1430     687 51.9% 15-Sep-96 03:12:16 +example.asm
  197.     3323    1487 55.2% 27-Feb-00 08:49:02 +morse.asm
  198.     3808     965 74.6% 27-Feb-00 08:49:02 +morse.h
  199.      942     422 55.2% 27-Feb-00 08:49:02 +pic16c84.h
  200.     1141     339 70.2% 27-Feb-00 08:49:02 +picmac.h
  201.     8260    2025 75.4% 27-Feb-00 08:49:02 +expr.c
  202.     1433     760 46.9% 27-Feb-00 08:49:02 +LICENSE
  203.     5465    1571 71.2% 27-Feb-00 08:49:02 +pic12bit.c
  204.     5585    1525 72.6% 27-Feb-00 08:49:02 +pic14bit.c
  205.    32558    9155 71.8% 27-Feb-00 09:03:28 +picasm.c
  206.     7700    3001 61.0% 27-Feb-00 08:49:02 +picasm.doc
  207.     7639    2976 61.0% 27-Feb-00 08:49:02 +picasm.h
  208.       48      48  0.0% 27-Feb-00 08:49:02 +README
  209.      414     207 50.0% 27-Nov-99 21:27:52 +smakefile
  210.     3874    1266 67.3% 27-Feb-00 08:49:02 +symtab.c
  211.    16530    4043 75.5% 27-Feb-00 08:49:02 +token.c
  212.    15687    3873 75.3% 03-Apr-00 19:37:10 +picprog.c
  213.     3034    1086 64.2% 24-Apr-00 16:50:26 +picrecv.c
  214.       79      55 30.3% 28-Feb-00 01:17:02 +picreset.s
  215.      557     318 42.9% 24-Apr-00 16:57:04 +picsend.asm
  216. -------- ------- ----- --------- --------
  217.   225045   88943 60.4% 24-Apr-100 22:08:06   29 files
  218.